home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / STUTTGART / UTIL / DISKUTIL / ADFS_SWI_TRAP / _files / _ADFSwiTRA / README < prev    next >
Text File  |  1990-04-18  |  4KB  |  92 lines
  1.  
  2.  
  3. Module  : ADFSswi converter
  4. Author  : S. van Aardt
  5. Version : 1.11
  6. Date    : April 1990
  7.  
  8.  
  9. Revision : 1.11 Now conforms with the latest SCSI Firmware (1.11),
  10.            which is compatible with Acorns SWI calls.
  11.  
  12. Purpose : When active it will direct some ADFS swi calls to the SCSI,
  13.           thus enabling the use of a standard disc editor on your
  14.           SCSI hard disk.
  15.  
  16. CONTROL : 
  17.           This program takes the form of a module, it sits in memory until
  18.           you either RMKILL/RMCLEAR it or do a CTRL-BREAK. 
  19.  
  20.      1)   To turn it on (ie start translation of SWIs) type *TRAPON , it
  21.           will remain ON until the module is killed, or a memory shift
  22.           (RMTIDY) takes place. Pressing BREAK will not affect it.
  23.                      
  24.      2)   To turn it off (ie stop translation, but still stays resident),
  25.           type *TRAPOFF. 
  26.  
  27.      3)   At any time you can check to see whether it's ON or OFF by typing
  28.           *TRAPSTAT .
  29.  
  30. USEAGE :
  31.           Modules such as Clares Toolkit/Toolkit+, and Instigator have
  32.           disk editing and sector load/save features. Normally you can't
  33.           use these because they assume that you've got an ADFS hard disk.
  34.           That was fine a year or two ago, there weren't any SCSI's about
  35.           for the Archimedes then (well not in general production).
  36.           They generally make use of the ADFS_DiscOp to read sectors from
  37.           the disk. This program traps those calls and substitues a
  38.           SCSI_DiscOp in it's place. Depending upon how the Caller has been
  39.           writen this facility should be enough to get most of the
  40.           facilities working, for completion I've also included several
  41.           other ADFS_ calls. The complete list is given at the end.
  42.  
  43.           Clares Toolkit+ is probably the fastest disk editor however is
  44.           pre-RiscOs and doesn't cope with E-FORMATed floppies, however you
  45.           can fool it into reading your disk by initially starting off with
  46.           a disk using the old format and then swapping it for the new one.
  47.           Happily there's no immediate problem with reading the Hard disk.
  48.           Unforunately it doesn't get the disk size quite right - in my case
  49.           it sees the Hard disk as &C6C6C00 bytes (196 MBYTES !!!). When
  50.           you attempt to access a non-existant sector nothing happens so
  51.           you needn't worry about damaging your hard disk.
  52.  
  53.           Instigator - this product does cope with the RiscOS format, and
  54.           also the IBM 360/720 formats. And will also attempt to read a
  55.           USER format. This is rather a slow disc editor, and everything 
  56.           else about it appears to be slow too. When reading from the Hard
  57.           Disk you'll have to select user mode. This is due to the way the
  58.           Module has been written - it recognises the Hard disk but doesn't
  59.           read any data from it - unusual because it does so in the RiscOS
  60.           mode (but only thinks of it then as an 800K floppy !!) - Well
  61.           you do go from one extreeme to another occasionally - although
  62.           I personally prefer Clares optimisitic view !!!
  63.  
  64.           !PcDir - this is a public domain MSDOS disk reader. If you want to
  65.           copy files to and from MSDOS disks then I seriously recommend you
  66.           get a copy of this - the latest version if reasonably fast.
  67.           When the ADFSswi module is active you'll be able to use the 
  68.           Harddisk option as well. This appears to be only a matter of an
  69.           initialisation problem - because it's advisable to *TRAPOFF if
  70.           you want to be able to use both an IBM floppy and H/d partition.
  71.           Note : You can also fool it into working with the hard disk if
  72.           you use *CONFIG. Harddisks 1 .
  73.  
  74.           There aren't many other programs which make use of the feature's
  75.           I've described above. Other may not work due to the way they've
  76.           been written. *** If in doubt use a backup copy first. ***
  77.  
  78. ADFS swi calls supported :
  79.  
  80.           ADFS_DiscOp       --------> SCSI_DiscOp
  81.           ADFS_Drives       --------> SCSI_Drives
  82.           ADFS_DescribeDisc --------> SCSI_DescribeDisc
  83.           ADFS_FreeSpace    --------> SCSI_FreeSpace
  84.  
  85.           The XSWI_ calls for the above are also supported.
  86.  
  87.  
  88.  
  89. ( S. van Aardt,  April 1990)
  90.  
  91.  
  92.